Node / meshtastic / Meshtastic-Android / files / .github / ISSUE_TEMPLATE / bug_report.yml

Displaying Raw • Download

Tff7b72nameTb4b4b4: Ta5d6ffBugTa5d6ff Ta5d6ffReport

Tff7b72descriptionTb4b4b4: Ta5d6ffFileTa5d6ff Ta5d6ffaTa5d6ff Ta5d6ffbugTa5d6ff Ta5d6ffreport.

Tff7b72titleTb4b4b4: Ta5d6ff"Ta5d6ff[Bug]:Te6edf3 Ta5d6ff"

Tff7b72labelsTb4b4b4: Tb4b4b4[Te6edf3bugTb4b4b4]

Tff7b72projectsTb4b4b4: Tb4b4b4[Te6edf3meshtastic/Meshtastic-AndroidTb4b4b4]

Tff7b72bodyTb4b4b4:

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffmarkdown

Tff7b72attributesTb4b4b4:

Tff7b72valueTb4b4b4: Tb4b4b4|

Tff7b72Thank you for helping to make Meshtastic-Android better by reporting a bug. :hugs:

Tff7b72Please provide as much detail as possible so we can efficiently address your issue and avoid unnecessary back-and-forth.

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffinput

Tff7b72idTb4b4b4: Ta5d6ffcontact

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffContactTa5d6ff Ta5d6ffDetails

Tff7b72descriptionTb4b4b4: Ta5d6ffHowTa5d6ff Ta5d6ffcanTa5d6ff Ta5d6ffweTa5d6ff Ta5d6ffgetTa5d6ff Ta5d6ffinTa5d6ff Ta5d6fftouchTa5d6ff Ta5d6ffwithTa5d6ff Ta5d6ffyouTa5d6ff Ta5d6ffifTa5d6ff Ta5d6ffweTa5d6ff Ta5d6ffneedTa5d6ff Ta5d6ffmoreTa5d6ff Ta5d6ffinfo?

Tff7b72placeholderTb4b4b4: Ta5d6ffex.Ta5d6ff Ta5d6ffemail@example.com,Ta5d6ff Ta5d6ffdiscordTa5d6ff Ta5d6ffusername

Tff7b72validationsTb4b4b4:

Tff7b72requiredTb4b4b4: Ta5d6fffalse

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffcheckboxes

Tff7b72idTb4b4b4: Ta5d6ffchecklist

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ff"Ta5d6ffChecklistTa5d6ff"

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72Please make sure you have done the following before submitting your bug report.

Tff7b72Bug reports that do not meet these criteria will be closed.

Tff7b72Requests that do not meet these criteria will be closed.

Tff7b72Links:

Tff7b72[**OPEN ISSUES**](https://github.com/meshtastic/Meshtastic-Android/issues)

Tff7b72[**CLOSED ISSUES**](https://github.com/meshtastic/Meshtastic-Android/issues?q=is%3Aissue+is%3Aclosed)

Tff7b72[Contribution Guidelines](https://github.com/meshtastic/Meshtastic-Android/blob/main/README.md#contributing)

Tff7b72optionsTb4b4b4:

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72I am able to reproduce the bug with the latest version.

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72I have updated to the latest *Alpha* firmware, and am able to reproduce the bug. Many issues are fixed quickly in alpha before the general beta release.

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72I made sure that there are no existing **OPEN or CLOSED issues** which I could contribute my information to.

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72I have taken the time to fill in all the required details. I understand that the bug report will be dismissed otherwise.

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72This issue contains only one bug.

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72I have read and understood the **Contribution Guidelines**.

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72I agree to follow this project's Code of Conduct

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72labelTb4b4b4: Tb4b4b4|

Tff7b72I actually read this list, and should be taken seriously.

Tff7b72requiredTb4b4b4: Ta5d6fffalse

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffinput

Tff7b72idTb4b4b4: Ta5d6ffapp-version

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffAffectedTa5d6ff Ta5d6ffappTa5d6ff Ta5d6ffversion

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72In which Meshtastic-Android app version did you encounter the bug?

Tff7b72Can be seen on the bottom of the `Settings` screen in the app.

Tff7b72placeholderTb4b4b4: Ta5d6ff"Ta5d6ffx.y.z-channel.xTe6edf3 Ta5d6ff(build)Te6edf3 Ta5d6ffflavorTa5d6ff"

Tff7b72validationsTb4b4b4:

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffinput

Tff7b72idTb4b4b4: Ta5d6ffphone-os

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffAffectedTa5d6ff Ta5d6ffAndroidTa5d6ff Ta5d6ffversion

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72With what operating system (+ version) did you encounter the bug?

Tff7b72placeholderTb4b4b4: Ta5d6ff"Ta5d6ffExample:Te6edf3 Ta5d6ffAndroidTe6edf3 Ta5d6ff14Ta5d6ff"

Tff7b72validationsTb4b4b4:

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffinput

Tff7b72idTb4b4b4: Ta5d6ffphone-model

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffAffectedTa5d6ff Ta5d6ffphoneTa5d6ff Ta5d6ffmodel

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72On what phone did you encounter the bug?

Tff7b72placeholderTb4b4b4: Ta5d6ff"Ta5d6ffExample:Te6edf3 Ta5d6ffSamsungTe6edf3 Ta5d6ffGalaxyTe6edf3 Ta5d6ffS20Te6edf3 Ta5d6ff/Te6edf3 Ta5d6ffGoogleTe6edf3 Ta5d6ffPixelTe6edf3 Ta5d6ff8Ta5d6ff"

Tff7b72validationsTb4b4b4:

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffinput

Tff7b72idTb4b4b4: Ta5d6ffhardware-model

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffAffectedTa5d6ff Ta5d6ffnodeTa5d6ff Ta5d6ffmodel

Tff7b72placeholderTb4b4b4: Ta5d6ff"Ta5d6ffExample:Te6edf3 Ta5d6ffSeeedTe6edf3 Ta5d6ffT1000-E,Te6edf3 Ta5d6ffHeltecTe6edf3 Ta5d6ffv3,Te6edf3 Ta5d6ffetc.Ta5d6ff"

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72On which hardware device (Node) did you encounter the bug?

Tff7b72validationsTb4b4b4:

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6ffinput

Tff7b72idTb4b4b4: Ta5d6fffirmware-version

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffAffectedTa5d6ff Ta5d6ffnodeTa5d6ff Ta5d6fffirmwareTa5d6ff Ta5d6ffversion

Tff7b72placeholderTb4b4b4: Ta5d6ff"Ta5d6ffx.x.xTa5d6ff"

Tff7b72descriptionTb4b4b4: Ta5d6ff"Ta5d6ffWhichTe6edf3 Ta5d6ffMeshtasticTe6edf3 Ta5d6fffirmwareTe6edf3 Ta5d6ffversionTe6edf3 Ta5d6ffdidTe6edf3 Ta5d6ffyouTe6edf3 Ta5d6ffencounterTe6edf3 Ta5d6fftheTe6edf3 Ta5d6ffbug?Ta5d6ff"

Tff7b72validationsTb4b4b4:

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6fftextarea

Tff7b72idTb4b4b4: Ta5d6ffsteps-to-reproduce

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffStepsTa5d6ff Ta5d6fftoTa5d6ff Ta5d6ffreproduceTa5d6ff Ta5d6fftheTa5d6ff Ta5d6ffbug

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72What did you do for the bug to show up?

Tff7b72If you can't cause the bug to show up again reliably (and hence don't have a proper set of steps to give us), please still try to give as many details as possible on how you think you encountered the bug.

Tff7b72placeholderTb4b4b4: Tb4b4b4|

Tff7b721. Go to '...'

Tff7b722. Press on '....'

Tff7b723. Swipe down to '....'

Tff7b72validationsTb4b4b4:

Tff7b72requiredTb4b4b4: Ta5d6fftrue

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6fftextarea

Tff7b72idTb4b4b4: Ta5d6ffactual-behavior

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffActualTa5d6ff Ta5d6ffbehavior

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72Tell us what happens with the steps given above.

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6fftextarea

Tff7b72idTb4b4b4: Ta5d6ffexpected-behavior

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffExpectedTa5d6ff Ta5d6ffbehavior

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72Tell us what you expect to happen.

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6fftextarea

Tff7b72idTb4b4b4: Ta5d6ffscreen-media

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffScreenshots/ScreenTa5d6ff Ta5d6ffrecordings

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72A picture or video is worth a thousand words.

Tff7b72Provide as much context as possible so we know what we are looking at.

Tff7b72Add screenshots or a screen recording to help explain your problem, provide detailed context to help us know what to look for.

Tff7b72GitHub supports uploads of images and (small) videos directly in the text box.

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6fftextarea

Tff7b72idTb4b4b4: Ta5d6fflogs

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffRelevantTa5d6ff Ta5d6fflogTa5d6ff Ta5d6ffoutput

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72Logs help us to diagnose and reproduce issues, particularly when they are unique to your setup.

Tff7b72Depending on the issue, the following logs may be useful:

Tff7b72- App logs: This will help with most issues. If possible, provide the relevant output of:

Tff7b72`adb logcat -d | grep com.geeksville.mesh`

Tff7b72- Mesh logs: UI issues, communication issues etc.

Tff7b72- ` App > Settings > Advanced > Debug Panel > Export specific / export all `

Tff7b72- Broader Android logs: Potentially useful if the issue goes beyond the app (connections, network etc.)

Tff7b72`adb logcat -d`

Tff7b72- Firmware logs: Useful for all connection issues with nodes

Tff7b72- These are piped to the USB serial port on the node, the most foolproof is to use the 'open serial' button on the web-flasher interface, and then save the output.

Tff7b72- The app needs to be connecting to the node via Bluetooth or Network for this to work.

Tff7b72renderTb4b4b4: Ta5d6ffshell

Tb4b4b4- Tff7b72typeTb4b4b4: Ta5d6fftextarea

Tff7b72idTb4b4b4: Ta5d6ffadditional-information

Tff7b72attributesTb4b4b4:

Tff7b72labelTb4b4b4: Ta5d6ffAdditionalTa5d6ff Ta5d6ffinformation

Tff7b72descriptionTb4b4b4: Tb4b4b4|

Tff7b72Any other information you'd like to include, for instance that

Tff7b72* the affected device is foldable or a TV

Tff7b72* you have disabled all animations on your device or otherwise changed system settings

Tff7b72* you are using battery optimization or power saving mode

Tff7b72* you are using a custom Android ROM or launcher

Tff7b72* your ferret chewed your antennas

Tff7b72* you are using a VPN

Tff7b72* you live in a faraday cage

Tff7b72* you dismissed all popups telling you not to do things you shouldn't do without reading them

Tff7b72* ...